BBS Toolkit

home *** CD-ROM | disk | FTP | other *** search

/ BBS Toolkit / BBS Toolkit.iso / qbbs / cbs_121r.zip / CBS_R.DOC next >

Wrap

Text File | 1990-05-18 | 36KB | 1,238 lines

COMPUTER SOFTWARE ASSOCIATION'S CALL BACK SYSTEM Version 1.20 Programming by Patrick Stierman Documentation by: Patrick Stierman and John Bierrie Copyright (C) 1990, Computer Software Association Copyrighted @ Feb,1990 ALL RIGHTS RESERVED CONTENTS -------- I. Introduction................................. i Copyright Notice............................. ii Shareware License............................ ii Shareware Registration....................... iii Warranty and Limit .......................... iii II. Installation................................. 1 CBSinst.Exe................................ 3 Local.Ctl.................................. 6 III. Appendix A Sample Batch Files......................... 8 IV. Appendix B Sample Menu & Registration Questionnaire... 11 V. Appendix C Support Systems............................ 12 VI. Registration................................. 13 VI. Notes........................................ 14 INTRODUCTION ************ This program was originally written to serve the needs of all high speed modem users. While trying to get several of the common Call back verifiers up and on-line with my BBS I came to the conclusion that these programs were written for the low speed modem users. Higher speeds and Locked port support was added as an afterthought. These programs were often well written but the programmer had no way to test out the code. Thus along came the 'well it works for me it should work for you syndrome. After several months of fighting these problems I decided to write a Call Back Verifier program that WORKS with the HST modems and others that use Locked Baud rates to the fossil. Thus along came this Program. I wrote this program for my BBS only, when someone else heard I had one that worked. Thus a shareware version came to be. I had only supported locked baud rates in the original program and had to allow for floating connect rates. The program was rewritten to include these support functions. Then came the realization that not everyone had 100% Hayes compatible modems. Oh well, back to the drawing board and out comes the config.dat file. Trying to keep required files at a minimum I had to add only one more file to define local calls for those who don't want to call all over the USA on their dime. Local.ctl fills that requirement. Thus to run this program, there are only three files required instead of the 6 or more for most other verifiers. Somewhere along the line, in the beginning of 1990, John Bierrie and I teamed up together to put together a "complete" package. What you are seeing here is the beginnings of those efforts. We know we have a long way to go, but we are working on it and hope we are heading in the right direction. We want to supply you, our users, with excellent software, coupled with excellent support, for no matter how good the software is, support will always be remembered first. As with all programs there will be upgrades and revisions as the users request or demand options I didn't think of. The latest version of this software will always be available for D/L on the support BBS Fido addresses 322/325 and 114/70. The boards are HST and up 24 hours except during ZMH. Stop by and also check out some of the other fine software available on these BBS's. The newest release of CBS will always be available for D/L on these BBS's. You may also FREQ CBS on 322/325 114/70 as CBS_R and get the latest release that way. Patrick Stierman Author - CBS i COPYWRITE NOTICE **************** No part of this manual may be reproduced, transmitted or translated into any language, in any form or by any means, except as described in the following license with out the prior written permission of "CSA". You are granted a limited license to use this software described in this manual. The software may be used or copied only in accordance with the terms of the license agreement within this manual. SOFTWARE LICENSE ================ This software is provided to run on one machine and one machine only. It is non-transferable. You may use this software on a limited basis for a trial period (30)days. After this evaluation you must either register it or cease to use said software. You may make copies of this software to be distributed only in the original format and package. You may NOT delete any files from the initial distribution package. The archived file must remain intact. You may NOT charge any fee for this service to distribute. You may upload the distribution archive to any bbs you desire as long as the software has not been modified. CSA's Call Back System must not be released or included in any other software package with out a written agreement from "CSA". Operators of BBS systems or electronic mass media systems may post the original unmodified archived package for download by their users without written permission as long as no fee is charged for the downloading of the file. Access fees may be charged but no fee must be charged for the specific downloading of CBS. ii SHAREWARE REGISTRATION ********************** Computer Software Association's Call Back System is not PUBLIC DOMAIN software. It is SHAREWARE. If you use it for more than the trial period (ie 30 days), you must pay and register it. The registration fees are as follows: $12.95 (non-commercial environment) $50.00 (commercial environment) Multiple copies - negotiable Registration entitles you to bug fixes, notification of NEW RELEASES and registered versions of the new releases until otherwise stated by CSA. The registration form is located at the end of this manual. Please fill it out completely to allow us to contact you should the need arise. That is to forward any bug fixes that HOPEFULLY will never be required. MAIN SUPPORT BBS's: Micro Hub BBS Doc's Place BBS Fido 1:114/70 Fido 1:322/235 (602) 649-9412 (508) 520-4564 Registration information Please make all checks or money orders payable to: CSA Send to: CSA C/O John Bierrie 658 Old West Central St. Franklin, Ma 02038 The "commercial" registration entitles you to other services not covered in this document. For further information, contact John Bierrie directly. WARRANTY and LIMITS ******************* This software is provided "AS IS" without any expressed or implied warranties whatsoever. No warranty of fitness for a particular purpose is offered. The author of this software and "CSA" cannot be held responsible for DIRECT, INDIRECT INCIDENTAL, CONSEQUENTIAL, or ANY OTHER damages due to your ability or inability to use this software, even if the author has been advised of the possibility of such damages. The user assumes full responsibility for the use of this software. iii FILES INCLUDED IN THIS PACKAGE ------------------------------ CBS.EXE <------ Actual CBS program CBSINST.EXE <------ CBS installation program CONFIG.DAT <------ Sample Configuration file CBS_R.DOC <------ These Documents CBS.MNU <------ Sample Menu REGISTER.Q-A <------ Sample Registration Questionnaire to work with CBS menu REGISTER.ASC <------ Sample explanation file for CBS READ.ME <------ Last minute changes, information, etc. SYSTEM REQUIREMENTS ------------------- Remote Access .003 or greater MS-DOS 2.1 or later HAYES compatible modem iv INSTALLATION ------------ Welcome to CSA's Call Back System. With this program, Sysops' have the ability to upgrade new user access automatically, enhance the security of their system and provide some "unique" services to the users. This version supports Remote Access versions .003 and above, unless they do some drastic changes in the code with future releases. This version is intended "ONLY" for single line use, no provisions are made for those operating multi-line systems. You may find it adaptable for use on one line, of a multi-line system, but there are no guarantees that it will work. There are two support files required with this program and are supplied in the distribution package. There are also three sample files, one Menu and one Questionnaire and an Information file. Their usage is described separately, later on in the documentation and are completely optional. CBS will support locked or unlocked ports at all valid baud rates from 300 - 38400. CBS's options are controlled by utilizing "switches", placed on the command line calling up the CBS program. Example: CBS /L=19200 /F=C:\FD\RA\CBS.LOG SWITCHES -------- /U LOCATION OF THE USERS.BBS FILE This command tells CBS where to find "USERS.BBS" if it is not located in the default subdirectory. Used for those who place their message base in a separate directory. CBS /U=C:\FD\RA /L LOCKED PORT This command line switch tells CBS the modem and com port are locked to the following speed. CBS /L=19200 or CBS /L=38400 /C CALL BACK OPTION (no security or flag changes) Directs CBS to act as a "Call Back System" and not upgrade the user's Security Level or Flags. CBS /C 1 /F LOG FILE You may specify a separate log file for CBS, or default to the Remote Access "System.log" : CBS /F=C:\FD\RA\CBS.Log /F= Supports Full Drive and Path format NO command line switch /F will result in default to the Remote Access System.Log /T TEST MODE To test CBS in the LOCAL test mode. This is used for you to test the apparition of the program. All function will work as expected, so remember to use a "test" user, since the security level and flags will be changed accordingly. CBS /T You may use any combination of the above switches, depending on your needs, on the command line. CBS also *** MUST *** have the modem configured to disconnect users by dropping DTR. In the next version we will add support to disconnect users with modem control strings. To install "CBS" on your system, create a type 7 menu option and enter in the following: [V]... Automatic Verifier - Call Back Registration System User display Action Type 7 Exit Optional Data CBS /L=19200 /F=C:\LOGS\CBS.LOG <--- your settings here Hot-Key V <--- your choice here The rest may be set up as you wish. Using a Type 15 exit is perfectly acceptable, but generally unnecessary when using Remote Access. Next place the CBS.EXE, LOCAL.CTL, CONFIG.DAT and CBSINST.EXE files in the same subdirectory as your main RA files are located. Run the CBSINST program... See next area. 2 CBSINST.EXE ----------- ******************************* FIRST OF ALL!!!! ***************************** If you were running a previous version of CBS, (before 1.20) or any version of "MBV" you MUST delete the OLD Config.Dat file before running CBSINST !!! ****************************************************************************** Run CBSINST.EXE to setup the "CONFIG.DAT" file. A default "CONFIG.DAT" is supplied for reference. This is where the program gets its information on what it is to do with each user. It has provisions for setting the new security level and for changing all of the user's flags. These changes take effect immediately after verification of password and re-entry into Remote Access. Once you have run CBSINST.EXE and are completely satisfied that every thing is operating correctly, CBSINST.EXE may be removed from your disk. Use keys F1 to Exit/Save and F2 to Exit (no saving) the CBSINST program. NEW USER This is the level each new user has, as set in your RACONFIG (MISC/SECURITY), and is a number from 1 to 32000. It must not be a 0, as zero is what Remote Access uses to lock out a user hence, someone with this level would never have access to this program, or possibly your system. MEMBER Is the NEW security level you wish a verified user to have. It also must be an integer between 1 and 32000. 3 SECURITY FLAGS The next four entries are for upgrading the user's Flags when they have been verified. Each set of flags can have 2 states, [on] or [off]. By using one of the 4 options for each flag, you have complete control over what CBS does to the flags. (You must put one in each flag slot!!) <*> Tells CBS to ignore this flag. Whatever state the flag was in remains after verification. <X> Force this flag ON. No matter what the flag was. It will be forced on. <-> Force this flag off. Again as above no matter the original state this flag will be forced off. <?> This toggles the flag. If it was originally ON it is changed to OFF. Likewise if it was originally OFF it will be changed to ON. MODEM INITIALIZATION In this release, this setting is not utilized by CBS so it is NOT mandatory to set your initialization string. This should be set however, to speed up upgrading to newer versions of CBS, as later releases will implement this. (as needed) NOTE: Should you have any difficulty in getting CBS to operate correctly, we can supply you with a version with this setting active, but this is only needed for systems with NON (100%) HAYES compatible modems. Let us know if you think you may need this. MODEM DIAL PREFIX These are the codes sent to the modem prior to dialing a number. Normally ATDT for Hayes compatible modems. This can also be used for entering in any special dialing commands you might need, such as a "9" for outside lines and the like. ATDT~9~~ 4 MODEM DIAL SUFFIX Is the command set to the modem after the dial string is sent. Normally a | or <cr>. This instructs the modem to begin dialing the number. MODEM OFF HOOK COMMAND The is the command the modem needs to go OFF HOOK, that is, to pick up the phone. It is usually ATH1| MODEM ON HOOK COMMAND This is the command to tell the modem to HANG UP the phone, or go "on hook". It is usually ATH0| DEFAULT AREACODE Area code CBS will use if user neglects to enter one when initially logging on. SYSOP NAME Your name. Use only a space between first and last name. RESUMEBBS Is a Y or N entry telling CBS to either log off after verification or Resume BBS operation. A <Y> will allow the user back into the calling menu in Remote Access. LocalResume To allow the system to call back "local" users as defined in the Local.ctl file. LD Resume To allow the system to call back "Long Distance" numbers. Any phone number entered as long distance in the Local.ctl file. LOCAL COLOR This Flag will toggle Local Color on and off only on the local display. Color will still be display to the user if his graphics flag is on. 5 DUP CHECK This is either a Y or a N telling CBS to check for duplicate phone entries. CHECK LEVEL If you specify Y in the previous entry Dup Check, then you will need to set the level of checking. Level 0, 1 or 2 is to be set as follows: Level 0 Send nothing to the log about a possible duplication. The program will show on the screen that a duplication has occurred, but will do nothing about it. Level 1 Send only a report to your system log. It will log the name of the current user as well as the name of the user that also has that same phone number. Level 2 Check for duplicate numbers, then LOCKOUT that user record IF the phone number duplicates another users. 6 LOCAL.CTL ********* LOCAL.CTL is the file that tells CBS which numbers are local calls. You can now tell CBS to call any number anywhere, but still have full control on what numbers will be allowed. We did this for the SysOps in large towns or densely populated areas that have many local or low cost dial zones. We recognize that there are two "schools of thought" on this matter. One feels that the SysOp should only have to "block" out those numbers he/she doesn't want his/her system to call, others feel he/she should put "in" those which are allowed. We opted to go with the idea that you, the SysOp should "put in" those numbers, prefixes, etc., that you want called. For one, the list is usually shorter than all the areacodes in the country (and Canada), for another, what happens when the phone company "adds" a new areacode someplace and you don't know about it??, and lastly, just for the sake that, we, as SysOps, like "knowing" what, where, how, our system is going to operate and in this case, "WHO" it might be calling. CBS now looks at the local.ctl file a little differently than before. There are now several control characters that CBS uses to control the dialing of the modem. Shown in the sample below are the flags and how they work. All new area codes must be precede with one of the 4 flags allowed. Else CBS will not be able to tell the difference between a new area code or just additional prefixes for the last area code. The flags are described below. SAMPLE LOCAL.CTL +602 @602 213 123 456 234 789 #789 790 791 !792 145 235 236 etc.... >>>NOTICE<<< each prefix is on it's own line with nothing following. The file must follow this layout exactly or else the program will fail to find matches and all numbers would appear as Long Distance calls and CBS won't call them. 7 DESCRIPTION OF AREACODE FLAGS (+) This is the first entry and tells CBS the actual AREA CODE which is local for you. Put your area code here. This will be the same areacode you entered as the "default" in the install program. (@) Tells CBS that all prefixes that follow are local calls and are ok to call. CBS will call the number as a 7 (seven) digit number. ie (999-9999). (#) Tells CBS that there is a new area code or that the dialing conditions have changed. The # flag denotes that the next set of prefixes require a 1 in front of the number to dial that number. The prefixes that follow are also OK to dial. ($) Tells CBS that there is a new area code or that the dialing conditions have changed. The $ flag denotes that all prefixes that follow are OK to dial and require 1+area code+ number to dial. CBS Will still NOT call any prefix or number unless it is included in the local.ctl file. It works that way to give the sysop total control over who CBS calls. That way CBS can't call Long Distance unless YOU tell it to. Area codes can be duplicated under different flags as it is quite possible to have local calls to certain prefixes and also Long distance calls in the same city to different prefixes. 8 EXAMPLE - Local.ctl : +602 @602 464 #602 986 1. 602-464-1270 and 2. 602-986-1111 Phone number one is local to my area and phone number two is long distance. Number 2 requires a 1 in front of the number to dial where as number 1 does not. These would go into the Local.ctl files like this. This tells CBS to call 464 as local and 986 as 1+number. As long as the prefixes are in Local.ctl then they are valid numbers to call. If you exclude any prefixes in the area then CBS won't be able to call that number as it can't find them in the Local.ctl file. This is a way to eliminate certain areas from being able to be called. (why someone would so this I really can't tell, But it is there just in case) **** 911 CANNOT BE DIALED!!! UNLESS YOU TELL IT TO **** Numbers such as 911 cannot be dialed as no one would actually have 911 as a prefix to their number. Thus 911 calls are filtered out totally. Neat huh.... If 911 is not in the Local.ctl file then CBS won't dial it..... 8 APPENDIX A... SAMPLE BATCH FILES FOR TYPE 15 USE ONLY!! The following is an extraction from my Mailer.bat file that runs Micro Hub BBS. CBS works here with this setup quite well. I am sure there are other ways of doing this but this works for me. STAND-ALONE Remote Access BATCH FILE ------------------------------- :After_RA If Errorlevel 61 goto start If Errorlevel 60 goto Leech If Errorlevel 51 goto Start If Errorlevel 50 goto CBS If Errorlevel 41 goto Start If Errorlevel 40 goto Bimodem If Errorlevel 11 goto Start If Errorlevel 10 goto Outside If Errorlevel 5 goto Net_Echo If Errorlevel 4 goto Echo_Only If Errorlevel 3 goto Net_Only goto Start ... :CBS CBS /l=19200 goto Restart_RA :RESTART_RA cd\qbbs RA -r -e0 goto After_RA ... :out Echo MicroHub BBS ......GOING.....GOING.....GONE 9 REMOTE ACCESS WITH MAILER SAMPLE BATCH FILES TYPE 15 EXIT ONLY!! ---------------------------------------------------------------- Sample batch file to work with Front Door, DBridge, etc... @ECHO OFF :start c: cd\fd fd if ERRORLEVEL 200 goto unpackmail if ERRORLEVEL 196 goto 9600_Baud if ERRORLEVEL 124 goto 2400_Baud if ERRORLEVEL 112 goto 1200_Baud If ERRORLEVEL 36 goto local if ERRORLEVEL 1 goto out if ERRORLEVEL 0 goto start goto start :9600_Baud cd\fd\RA RA -b2400 -E0 -P if ERRORLEVEL 30 goto CBS if ERRORLEVEL 14 goto CBSCBACK goto After_RA :2400_Baud cd\fd\RA RA -b2400 -E0 -P if ERRORLEVEL 30 goto CBS if ERRORLEVEL 14 goto CBSCBACK goto After_RA :1200_Baud cd\fd\RA RA -b1200 -E0 -P if ERRORLEVEL 30 goto CBSCBACK if ERRORLEVEL 14 goto CBS goto After_RA :After_RA if ERRORLEVEL 9 goto start if ERRORLEVEL 6 goto Maintain if ERRORLEVEL 5 goto Net&echo if ERRORLEVEL 4 goto Echo if ERRORLEVEL 3 goto Net if ERRORLEVEL 0 goto start goto start :CBSCBACK CBS /L=19200 /C /F=C:\logs\callback.log goto Restart_RA :CBS CBS /L=19200 /F=C:\LOGS\CBS.LOG goto Restart_RA 10 :Outside CTTY COM2: WATCHCD COM2: ON <PROGRAM NAME> WATCHCD COM2: OFF CTTY CON: goto Restart_RA :Restart_RA RA -R -E0 -P if ERRORLEVEL 30 goto CBSCBACK if ERRORLEVEL 14 goto CBS goto After_RA :out 11 APPENDIX B... SAMPLE MENU & REGISTRATION QUESTIONNAIRE FILES ---------------------------------------------- Included with the CBS System package, are three additional files to help you make a "Clean and Neat" installation of the CBS program. You are welcome to use them, modify them or just plain throw them out... I do not have the time, nor space to go into what can be done with security levels and flag settings on your board, in this document, suffice it to say, a whole world of "tricks" can be done. Should anyone, who registers the program, wish to discuss the possibilities, you are most welcome to call and do so. CBS.MNU Call this menu up from your "TOP" menu using whatever command you are comfortable with. I use "R". This menu will allow the user to read about the "whys and hows" of the CBS system, answer a Registration Questionnaire and then use the CBS program itself. NOTE: If you use this menu, please remember to "Edit" line # 10 of the menu to reflect your name. REGISTER.Q-A Sample Registration.Q-A used by my system. REGISTER.ASC Sample "Information" file accessed by the CBS.MNU explaining a little about who needs to use the CBS, why it is used and what to expect while using it. To give you a "brief" idea of what can be done with "Flag Settings". On my system, flags are set so that the first time the user comes into the CBS.MNU, all he/she sees is the option to answer the questionnaire and the "information" file. The actual option for using the verifier is "hidden" with a flag until AFTER he/she has answered the questionnaire. Once that is done, the new user is returned to the CBS.MNU menu and shown only the Verifier option. Upon being verified, and subsequently returned to the main menu (I use a type 15 exit for this), the user in not allowed to enter the Registration menu (CBS.MNU) again. If you understand what I just "explained", then you are well on your way to understanding flags, and what they can do for you. If not, then give me a call sometime and we can discuss it. John 12 APPENDIX C... SUPPORT SYSTEMS --------------- The following boards act as "Support Systems" for CSA and the CBS program. Each system carries the latest release of CBS requestable with the Magic Name of "CBS_R". Each system is also tied together via NetMail to insure the fastest responses to any questions or concerns. For those wishing to keep up with further developments of the CBS program and other software we will be producing, the CSA_PROD Echo is being made available on the Backbone and you may request it from your REC's, NEC, or whomever you get your mail from. This echo will also be used to discuss "low priority" problems and the like. WESTERN REGION EASTERN REGION -------------- -------------- 1:114/70 1:322/235 Micro Hub Doc's Place BBS Mesa, Az. 85201 Franklin, Ma. 02038 602-649-9412 508-520-4574 Sysop - Patrick Stierman Sysop - John Bierrie 14 REGISTRATION FORM ================= Use your name and BBS name "exactly" as they appear on your system!! * Sysop's Name...........___________________________________ * BBS Name...............___________________________________ * BBS Phone Number.......___________________________________ * FidoNet Number.........___________________________________ (if applicable) * Address................___________________________________ ___________________________________ ___________________________________ * Company Name...........___________________________________ (if applicable) Costs: Call Back System - Single copy: $12.95 (non-commercial) - Single copy: $50.00 (commercial) - Multiple copy: Write for more information. Please make all checks or money orders payable to: (Please, do not send CASH... it is too easily lost!) CBS Send to: CBS C/O John Bierrie 658 Old West Central St. Franklin, Ma 02038 Registration entitles you to new releases as they become available. Registration will also entitle you to telephone support. No number will be given until you have registered. Any questions until registered, will be handled via snail mail, FIDO mail - addresses 322/235 or 114/70 or by logging on to one of the support BBS,s: Micro Hub BBS Doc's Place (602) 649-9412 (508) 520-4574 HST 23 Hours HST 23 Hours 1:114/70 1:322/235 Thank You For Supporting Shareware Software................ 15